home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 April / Software of the Month Club 1996 April.iso / pc / os2 / psutils / man / psnup.doc < prev    next >
Text File  |  1996-02-21  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. PSNUP(1)                                                 PSNUP(1)
  5.  
  6.  
  7. NAME
  8.        psnup - multiple pages per sheet
  9.  
  10. SYNOPSIS
  11.        psnup  [  -wwidth ] [ -hheight ] [ -ppaper ] [ -Wwidth ] [
  12.        -Hheight ] [ -Ppaper ] [ -l ] [ -r ] [  -f  ]  [  -c  ]  [
  13.        -mmargin  ] [ -bborder ] [ -dlwidth ] [ -sscale ] [ -nup ]
  14.        [ -q ] [ infile [ outfile ] ]
  15.  
  16. DESCRIPTION
  17.        Psnup puts multiple logical pages onto each physical sheet
  18.        of  paper.   The  input  PostScript file should follow the
  19.        Adobe Document Structuring Conventions.
  20.  
  21.        The -w option gives the paper width,  and  the  -h  option
  22.        gives  the paper height, normally specified in cm or in to
  23.        convert PostScript's points (1/72 of an inch) to  centime-
  24.        ters  or inches.  The -p option can be used as an alterna-
  25.        tive, to set the paper size to a3,  a4,  a5,  b5,  letter,
  26.        legal,  tabloid,  statement,  executive,  folio, quarto or
  27.        10x14.  The default paper size is letter.  The -W, -H, and
  28.        -P  options  set  the input paper size, if it is different
  29.        from the output size. This makes it easy to  impose  pages
  30.        of one size on a different size of paper.
  31.  
  32.        The  -l option should be used for pages which are in land-
  33.        scape orientation (rotated 90 degrees anticlockwise).  The
  34.        -r  option  should be used for pages which are in seascape
  35.        orientation (rotated 90 degrees  clockwise),  and  the  -f
  36.        option  should  be used for pages which have the width and
  37.        height interchanged, but are not rotated.
  38.  
  39.        Psnup normally uses  `row-major'  layout,  where  adjacent
  40.        pages  are placed in rows across the paper.  The -c option
  41.        changes the  order  to  `column-major',  where  successive
  42.        pages are placed in columns down the paper.
  43.  
  44.        A  margin  to leave around the whole page can be specified
  45.        with the -m option. This is useful for sheets  of  `thumb-
  46.        nail'  pages,  because the normal page margins are reduced
  47.        by putting multiple pages on a single sheet.
  48.  
  49.        The -b option is used  to  specify  an  additional  margin
  50.        around each page on a sheet.
  51.  
  52.        The -d option draws a line around the border of each page,
  53.        of the specified width.  If the lwidth parameter is  omit-
  54.        ted,  a  default  linewidth  of  1  point  is assumed. The
  55.        linewidth is relative to  the  original  page  dimensions,
  56.        i.e. it is scaled down with the rest of the page.
  57.  
  58.        The  scale  chosen  by psnup can be overridden with the -s
  59.        option. This is useful to merge pages  which  are  already
  60.        reduced.
  61.  
  62.  
  63.  
  64.                  PSUtils Release 1 Patchlevel 16                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PSNUP(1)                                                 PSNUP(1)
  71.  
  72.  
  73.        The -nup option selects the number of logical pages to put
  74.        on each sheet of paper. This  can  be  any  whole  number;
  75.        psnup  tries  to  optimise  the layout so that the minimum
  76.        amount of space is wasted. If psnup cannot find  a  layout
  77.        within  its  tolerance  limit, it will abort with an error
  78.        message. The alternative form i nup can also be used,  for
  79.        compatibility with other n-up programs.
  80.  
  81.        Psnup  normally  prints  the page numbers of the pages re-
  82.        arranged; the -q option suppresses this.
  83.  
  84. EXAMPLES
  85.        The potential use of this utility is varied but  one  par-
  86.        ticular  use  is in conjunction with psbook(1).  For exam-
  87.        ple, using groff to create a PostScript document  and  lpr
  88.        as  the  UNIX  print  spooler a typical command line might
  89.        look like this:
  90.  
  91.        groff -Tps -ms file | psbook | psnup -2 | lpr
  92.  
  93.        Where file is a 4 page document this command  will  result
  94.        in a two page document printing two pages of file per page
  95.        and rearranges the page order to match the input  pages  4
  96.        and  1  on the first output page and pages 2 then 3 of the
  97.        input document on the second output page.
  98.  
  99. AUTHOR
  100.        Copyright (C) Angus J. C. Duggan 1991-1995
  101.  
  102. SEE ALSO
  103.        psbook(1), psselect(1), pstops(1),  epsffit(1),  psnup(1),
  104.        psresize(1), psmerge(1), fixscribeps(1), getafm(1), fixdl-
  105.        srps(1),  fixfmps(1),  fixmacps(1),  fixpsditps(1),  fixp-
  106.        spps(1),  fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1),
  107.        extractres(1), includeres(1)
  108.  
  109. TRADEMARKS
  110.        PostScript is a trademark of Adobe Systems Incorporated.
  111.  
  112. BUGS
  113.        Psnup does not accept all DSC comments.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                  PSUtils Release 1 Patchlevel 16                2
  131.  
  132.  
  133.